/**
 * Copyright (c) 2008 Luciano Bustos - riaevolution.com, All Rights Reserved.
 * 
 * Contact luchyx@riaevolution.com
 * See www.riaevolution.com
 *  
 * Permission is hereby granted, free of charge, to any person obtaining a copy of 
 * this software and associated documentation files (the "Software"), to deal in 
 * the Software without restriction, including without limitation the rights to
 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
 * of the Software, and to permit persons to whom the Software is furnished to do
 * so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included in all 
 * copies or substantial portions of the Software.
 * 
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE. 
 * */
package com.riaevolution.cairngorm.event
{
	/**
	 * ChainFactory that help us to concatenate an array of events and trigger each event on result in the especific
	 * command.
	 * 
	 * @author Luciano Bustos
	 * 
	 */
	public class EventChainFactory
	{
		/**
		 * Concatena all events in order to produce a sequenced call to the desired command.
		 *  
		 * @param evts Array of events
		 * @param completeCallBack
		 * @return ChainEvent the first chained event 
		 * 
		 */
		public static function chainEvents( evts:Array, completeCallBack:Function=null ):ChainEvent
		{
			var len:int = evts.length;
			if ( len < 1 )
				return null;
				
			var returnEvent:ChainEvent = evts[0] as ChainEvent;
			
			var i:int = len-1;
			for ( i; i>=0; i-- )
			{
				if ( i != ( len-1 ) )
				{
					var e:ChainEvent = evts[i] as ChainEvent;
					var next_e:ChainEvent = evts[i+1] as ChainEvent;
					e.nextChainedEvent = next_e;
				}
			}
			//asign a lastCallback
			//trace("len1: "+len);
			//trace("callback: "+completeCallBack);
			if(completeCallBack!=null) {
				//trace("len2: "+len);
				if(len > 1)
					ChainEvent(evts[len-2]).nextChainedEvent.endCallBack = completeCallBack;
				else
					returnEvent.endCallBack = completeCallBack;
			}			
			return returnEvent;
		}
	}
}